|
This page last changed on Jun 28, 2011 by smaddox.
When connection pooling is enabled, the LDAP directory server maintains a pool of connections and assigns them as needed. When a connection is closed, the directory server returns the connection to the pool for future use. This can improve performance significantly.
To configure your LDAP connection pool:
- Log in as a user with the 'JIRA Administrators' global permission.
- Select 'Administration' > 'Users' > 'User Directories'.
Keyboard shortcut: 'g' + 'g' + start typing 'directories'.
- Click 'LDAP Connection Pool Configuration' in the 'Additional Configuration' section.
| Setting |
Description |
Default Value |
| Initial Pool Size |
The number of LDAP connections created when initially connecting to the pool. |
1 |
| Preferred Pool Size |
The optimal pool size. LDAP will remove idle connections when the number of connections grows larger than this value. A value of 0 (zero) means that there is no preferred size, so the number of idle connections is unlimited. |
10 |
| Maximum Pool Size |
The maximum number of connections. When the number of connections reaches this value, LDAP will refuse further connections. As a result, requests made by an application to the LDAP directory server will be blocked. A value of 0 (zero) means that the number of connections is unlimited. |
0 |
| Pool Timeout (seconds) |
The length of time, in seconds, that a connection may remain idle before being removed from the pool. When the application is finished with a pooled connection, the connection is marked as idle, waiting to be reused. A value of 0 (zero) means that the idle time is unlimited, so connections will never be timed out. |
30 |
| Pool Protocol |
Only these protocol types will be allowed to connect to the LDAP directory server. If you want to allow multiple protocols, enter the values separated by a space. Valid values are:
|
plain ssl
(Both plain and ssl) |
| Pool Authentication |
Only these authentication types will be allowed to connect to the LDAP directory server. If you want to allow multiple authentication types, enter the values separated by a space. See RFC 2829 for details of LDAP authentication methods. Valid values are:
|
simple |
Notes:
- The connection pool settings are system wide and will be used to create a new connection pool for every configured LDAP directory server.
- You must restart your application server for these settings to take effect.
RELATED TOPICS
Connecting to an LDAP Directory
Configuring User Directories
|